home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / pc_board / camsudr3.zip / CAMS-UDR.DOC < prev    next >
Text File  |  1992-03-19  |  9KB  |  197 lines
  1.             Welcome to Cam's Upload/Download Event Manger Program
  2.  
  3.      This is the World's easiest Upload/Download Manger that I know of for
  4. use with PCBoard 14.x Premium Bulletin Board Systems.  While working for
  5. Clark Development Compnay, Inc. we received a number of calls on how to use
  6. PCBSM.EXE with adjusting Security Levels according to the number of files or
  7. the number of Bytes downloaded.  To this day I still don't have a complete
  8. understanding of how it works.  The other day Reginald Hirsch (Runs a GREAT
  9. BBS in Houston, Texas, "Ye Olde Bailey BBS" 713-520-1569) called me up and
  10. asked if I could write a program like to PCBUDA.  However, I thought it could
  11. be done a little better and came up with this program.
  12.  
  13.      This program runs in your NIGHTLY EVENT.  It works GREAT!!!
  14.  
  15.      The program has been tested on both a Stand Alone IBM 286 Compatible with
  16. 1000 Users (Using PCBoard 14.5a).  The program was also tested on a 6 Node BBS
  17. using LANtastic with 3,500 users.  I've done a lot of testing, but I will not
  18. be responsible for anything that happens.  It's up to you to make sure that
  19. the config file(s) have been made properly.
  20.  
  21.      The program is very easy to setup and very configurable.  Everything that
  22. needs to be done is handled in a CONFIG file of your choice.  Here's the basic
  23. structure of the config file (Use a TEXT editor that puts a CR/LF at the end
  24. of each line):
  25.  
  26.   Line  1: E:\PCB\PCBOARD.DAT    [Path/Name of PCBOARD.DAT File]
  27.   Line  2: Y                     [Create the Bulletin File]
  28.   Line  3: BLT1                  [Path/Name of Bulletin File]
  29.   Line  4: @X0B                  [Border Color]
  30.   Line  5: @X0C                  [Inside Border Color]
  31.   Line  6: @X0E                  [Program Name Color]
  32.   Line  7: @X09                  [Users Name Color]
  33.   Line  8: @X0A                  [Num of File Uplds Color]
  34.   Line  9: @X0B                  [Num of File Dnlds Color]
  35.   Line 10: @X0C                  [File Ratio Color]
  36.   Line 11: @X0D                  [Num of Byte Uplds Color]
  37.   Line 12: @X0E                  [Num of Byte Dnlds Color]
  38.   Line 13: @X0F                  [Byte Ratio Color]
  39.  
  40. Note:  Lines 14 thru 18 are where the hard core of the program lies
  41.  
  42.   Line 14: 20     [GOOD USER LEVEL]
  43.   Line 15: 19     [BAD USER LEVEL]
  44.   Line 16: A      [A = Use a BYTE/FILE Ratio, B = Byte Ratio, F = File Ratio]
  45.   Line 17: 10     [Ratio to Use]
  46.   Line 18: 0      [Free Files Allowed before Adjusting Security (Only Used
  47.                    if you are using the F command [File Ratio)]
  48.  
  49.   repeat steps 13 thru 17 for any additional security levels to be adjusted.
  50.  
  51.   Line 18: STOP   [This should be your LAST LINE in your CONFIG file]
  52.  
  53.  
  54.   Okay, now let's go through a scenario here.  Okay Night of the Old BBS has
  55. these security levels:
  56.  
  57.    18 - Verified Public User (10 to 1 Download/Upload Ratio)
  58.    16 - Verified Public User (20 to 1 Download/Upload Ratio)
  59.    14 - Verified Public User (30 to 1 Download/Upload Ratio)
  60.    10 - Verified Public User (No Downloads Permited due to Ratio)
  61.  
  62.   Now, all we need to do is setup the CAMS-UDR.CNF file like this:
  63.  
  64.   Line  1: E:\PCB\PCBOARD.DAT    [Path/Name of PCBOARD.DAT File]
  65.   Line  2: Y                     [Create the Bulletin File]
  66.   Line  3: BLT1                  [Path/Name of Bulletin File]
  67.   Line  4: @X0B                  [Border Color]
  68.   Line  5: @X0C                  [Inside Border Color]
  69.   Line  6: @X0E                  [Program Name Color]
  70.   Line  7: @X09                  [Users Name Color]
  71.   Line  8: @X0A                  [Num of File Uplds Color]
  72.   Line  9: @X0B                  [Num of File Dnlds Color]
  73.   Line 10: @X0C                  [File Ratio Color]
  74.   Line 11: @X0D                  [Num of Byte Uplds Color]
  75.   Line 12: @X0E                  [Num of Byte Dnlds Color]
  76.   Line 13: @X0F                  [Byte Ratio Color]
  77.   Line 14: 18     [GOOD USER LEVEL]
  78.   Line 15: 16     [BAD USER LEVEL]
  79.   Line 16: F      [Use a File Ratio]
  80.   Line 17: 10     [Ratio to Use]
  81.   Line 18: 0      [Free Files Allowed before Adjusting Security]
  82.   Line 19: 16     [GOOD USER LEVEL]
  83.   Line 20: 14     [BAD USER LEVEL]
  84.   Line 21: F      [Use a F = File Ratio]
  85.   Line 22: 20     [Ratio to Use]
  86.   Line 23: 0      [Free Files Allowed before Adjusting Security]
  87.   Line 24: 14     [GOOD USER LEVEL]
  88.   Line 25: 30     [BAD USER LEVEL]
  89.   Line 26: F      [Use a File Ratio]
  90.   Line 27: 10     [Ratio to Use]
  91.   Line 28: 0      [Free Files Allowed before Adjusting Security]
  92.   Line 30: STOP
  93.  
  94. That's what a config file what look like for a BBS that uses that type.  What
  95. I suggest is that you start from your HIGHEST SECURITY LEVEL and see which
  96. levels you are going to put a Ratio on. Then make the config file from the
  97. Highest Security Level down to the Lowest.
  98.  
  99.   Now if a user is declared as a BAD User, once his Ratio is back to where
  100. it should be, the program will raise his security level to the GOOD USER level.
  101.  
  102. NOTE #1:  You can have up to 25 different securitys in the file.  If you need
  103.           more than 25, please let me know and I'll change the program around.
  104.  
  105. NOTE #2:  The Program is VERY FAST.  Hope you like it!!
  106.  
  107.  
  108.   Now, let's get figure out how we run this program.  In order for the program
  109. to work you need to pass TWO command line paramters to it.
  110.  
  111.   CAMS-UDR.EXE ConfigName options[/ADJUST, /MSGS:xxxx]
  112.  
  113.     ConfigName - This is the PATH/NAME of the Config File.
  114.  
  115.     /ADJUST    - This tells the program to ADJUST the security levels as
  116.                  needed.  If you don't run the /ADJUST switch, the program
  117.                  will only create a Bulletin (If you answered yes in the
  118.                  config file) file.  The purpose of the /ADJUST is to make
  119.                  sure you really want to adjust security levels.  If you
  120.                  want to look at the program in LOCAL mode, then just enter
  121.                  the config file name and let the program show you what's
  122.                  going to happen.
  123.  
  124.     /MSGS:xxxx - Here's where the BEEF of the program really lies.  What this
  125.                  feature does is notifies the user via a message in PCBoard
  126.                  that his/her security level has been adjusted.  Now, you may
  127.                  think that this is nothing, but let me tell you a story.
  128.                  I implemented this feature for a local board that I run for
  129.                  a friend of mine.  Once we started running the program, users
  130.                  started contributing more to the board (Both with UPLOADS and
  131.                  with monetary contributions $$$).  In about a two week period,
  132.                  we had 15 contributions come in (Not bad)!!
  133.  
  134.                  This feature requires that you create a text file called SECxx
  135.                  (where xx represents a security level).  This text file should
  136.                  explaine what the users security level and ratio is, and
  137.                  anything else that you feel you would like to add.  If you are
  138.                  running a paid board (Trying to get contributions), you might
  139.                  want to suggest in this text file that the user makes a
  140.                  contribution for a certain amount of money to waive the file
  141.                  ratio.  Believe me, it works!!  If you have any problems with
  142.                  this feature (Don't quite understand how it works), please
  143.                  give me a voice call.  I've included several example SECxx
  144.                  files that we used for this board.
  145.  
  146.                  In order for this to work properly, you will need to get ahold
  147.                  of Robert Vostrey's TXT2MSG.EXE program.  My program uses
  148.                  this program to insert the message (I was too lazy and didn't
  149.                  want add this feature <hehehe>).
  150.  
  151.                  The /ADJUST paramter is used in conjunction with this.  Be
  152.                  sure you add this to the command line if you wish to have the
  153.                  messages inserted.
  154.  
  155.                  The xxx represents the PATH/NAME of your MSGS file.  See my
  156.                  examples if you need help (Or give me a voice call).
  157.  
  158.  
  159.  
  160. ****** Examples *****
  161.  
  162.   CAMS-UDR CAMS-UDR.CNF /ADJUST /MSGS:C:\PCB\MAIN\MSGS
  163.  
  164.     This will adjust your users security level if they go beyond their present
  165.     ratio.  It will then post a message to the user indicating why their
  166.     security level was adjusted.
  167.  
  168.   CAMS-UDR CAMS-UDR.CNF
  169.  
  170.     This basically is just runs the program without actually updating the
  171.     USERS file.  It will let you see what users were adjusted (If you can
  172.     read as fast as it prints out <g>).
  173.  
  174.   CAMS-UDR CAMS-UDR.CNF /ADJUST
  175.  
  176.     This will adjust the ratios.  No messages will be left to users who were
  177.     adjusted.
  178.  
  179.  
  180.   Remember, this program should be run in your nightly event.  I have heard
  181.   of people running it in their $$LOGOFF.BAT file.
  182.  
  183.   That's really about it.  If you have any questions about the program you
  184. can reach me on either my BBS or at home:
  185.  
  186.   Node 1 - (801)489-3558 [HST 1440, Sorry, no V.32]
  187.   VOICE  - (801)489-8935 [Home/Business number]
  188.  
  189.   I can also be found on these Networks in the Sysops Conference:
  190.  
  191.        U'NI-net, and ILink
  192.  
  193.   --Cam--
  194.  
  195.   A big thank you goes to Reginald for his assistance with the Program!!
  196.  
  197.